Update Customer

cURL

curl --request PATCH \
  --url https://sandbox.veritusagent.ai/api/v1/customers/{customerId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "<string>",
  "middleName": "<string>",
  "lastName": "<string>",
  "email": "<string>",
  "primaryPhone": "<string>",
  "secondaryPhone": "<string>",
  "ssnLastFour": "<string>",
  "dateOfBirth": "2023-12-25",
  "address": {
    "line1": "<string>",
    "line2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zip": "<string>"
  },
  "collections": {
    "principalBalance": 1,
    "originalCreditor": "<string>",
    "accruedInterestAmount": 1,
    "totalBalance": 1,
    "chargeOffDate": "2023-12-25",
    "firstDelinquencyDate": "2023-12-25",
    "settlementAggregationRate": 1,
    "originalAccountNumber": "<string>",
    "itemizationBalance": 1,
    "postItemizationInterest": 1,
    "postItemizationFees": 1,
    "postItemizationCredits": 1,
    "postItemizationPayments": 1,
    "productType": "<string>",
    "originalProductType": "<string>"
  }
}
'

{
  "requestId": "96b887fb-9371-4515-b51e-28434f58dd7e",
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "externalId": "CUST-12345",
    "firstName": "Jane",
    "middleName": "Marie",
    "lastName": "Doe",
    "email": "[email protected]",
    "primaryPhone": "+12025551234",
    "secondaryPhone": "+12025555678",
    "address": {
      "line1": "456 Oak Ave",
      "line2": "Unit 12",
      "city": "Washington",
      "state": "DC",
      "zip": "20001"
    },
    "collections": {
      "principalBalance": 4500,
      "originalCreditor": "ABC Bank",
      "accruedInterestAmount": 250.5,
      "totalBalance": 4750.5,
      "chargeOffDate": "2023-01-15",
      "firstDelinquencyDate": "2022-06-01",
      "settlementAggregationRate": 0.65,
      "originalAccountNumber": "4111111111111111",
      "itemizationBalance": 4500,
      "postItemizationInterest": 150.25,
      "postItemizationFees": 100.25,
      "postItemizationCredits": 50,
      "postItemizationPayments": 200,
      "productType": "Credit Card",
      "originalProductType": "Visa Signature"
    },
    "ssnLastFour": "1234",
    "dateOfBirth": "1985-03-15"
  }
}

PATCH

customers

{customerId}

cURL

curl --request PATCH \
  --url https://sandbox.veritusagent.ai/api/v1/customers/{customerId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "<string>",
  "middleName": "<string>",
  "lastName": "<string>",
  "email": "<string>",
  "primaryPhone": "<string>",
  "secondaryPhone": "<string>",
  "ssnLastFour": "<string>",
  "dateOfBirth": "2023-12-25",
  "address": {
    "line1": "<string>",
    "line2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "zip": "<string>"
  },
  "collections": {
    "principalBalance": 1,
    "originalCreditor": "<string>",
    "accruedInterestAmount": 1,
    "totalBalance": 1,
    "chargeOffDate": "2023-12-25",
    "firstDelinquencyDate": "2023-12-25",
    "settlementAggregationRate": 1,
    "originalAccountNumber": "<string>",
    "itemizationBalance": 1,
    "postItemizationInterest": 1,
    "postItemizationFees": 1,
    "postItemizationCredits": 1,
    "postItemizationPayments": 1,
    "productType": "<string>",
    "originalProductType": "<string>"
  }
}
'

{
  "requestId": "96b887fb-9371-4515-b51e-28434f58dd7e",
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "externalId": "CUST-12345",
    "firstName": "Jane",
    "middleName": "Marie",
    "lastName": "Doe",
    "email": "[email protected]",
    "primaryPhone": "+12025551234",
    "secondaryPhone": "+12025555678",
    "address": {
      "line1": "456 Oak Ave",
      "line2": "Unit 12",
      "city": "Washington",
      "state": "DC",
      "zip": "20001"
    },
    "collections": {
      "principalBalance": 4500,
      "originalCreditor": "ABC Bank",
      "accruedInterestAmount": 250.5,
      "totalBalance": 4750.5,
      "chargeOffDate": "2023-01-15",
      "firstDelinquencyDate": "2022-06-01",
      "settlementAggregationRate": 0.65,
      "originalAccountNumber": "4111111111111111",
      "itemizationBalance": 4500,
      "postItemizationInterest": 150.25,
      "postItemizationFees": 100.25,
      "postItemizationCredits": 50,
      "postItemizationPayments": 200,
      "productType": "Credit Card",
      "originalProductType": "Visa Signature"
    },
    "ssnLastFour": "1234",
    "dateOfBirth": "1985-03-15"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

customerId

string<uuid>

required

The unique identifier of the customer to update

Body

application/json

firstName

string

The first name of the customer.

middleName

string

The middle name of the customer.

lastName

string

The last name of the customer.

string

The email address of the customer.

primaryPhone

string

The primary phone number of the customer. (E.164 format)

secondaryPhone

string | null

The secondary phone number of the customer. (E.164 format)

ssnLastFour

string | null

The last four digits of the customer's Social Security Number.

Required string length: 4

dateOfBirth

string<date> | null

The date of birth of the customer. YYYY-MM-DD format.

address

object

The address of the customer.

Show child attributes

address.line1

string | null

The first line of the address.

address.line2

string | null

The second line of the address (e.g., apartment, suite, unit number).

address.city

string | null

The city of the address.

address.state

string | null

The state of the address.

address.zip

string

The zip code of the address. Use 5 digits (12345) or 9 digits (12345-1234) format.

collections

object

Collections account information for the customer.

Show child attributes

collections.principalBalance

number | null

The principal balance amount.

Required range: x >= 0

collections.originalCreditor

string | null

The name of the original creditor.

collections.accruedInterestAmount

number | null

The amount of accrued interest.

Required range: x >= 0

collections.totalBalance

number

The total balance of the customer's collections.

Required range: x >= 0

collections.chargeOffDate

string<date> | null

The date when the account was charged off. (ISO-8601 format: YYYY-MM-DD).

collections.firstDelinquencyDate

string<date> | null

The date of the first delinquency. (ISO-8601 format: YYYY-MM-DD).

collections.settlementAggregationRate

number | null

The settlement aggregation rate.

Required range: x >= 0

collections.originalAccountNumber

string | null

The original account number.

collections.itemizationBalance

number | null

The itemization balance amount.

Required range: x >= 0

collections.postItemizationInterest

number | null

Interest accrued after itemization.

Required range: x >= 0

collections.postItemizationFees

number | null

Fees accrued after itemization.

Required range: x >= 0

collections.postItemizationCredits

number | null

Credits applied after itemization.

Required range: x >= 0

collections.postItemizationPayments

number | null

Payments made after itemization.

Required range: x >= 0

collections.productType

string | null

The current product type.

collections.originalProductType

string | null

The original product type.

Response

Customer successfully updated

requestId

string<uuid>

required

The request identifier.

success

boolean

required

Whether the update operation completed successfully.

data

object

required

The updated customer object.

Show child attributes

data.id

string<uuid>

required

The ID of the customer.

data.externalId

string

required

The ID of the customer in your system.

data.firstName

string

required

The first name of the customer.

data.lastName

string

required

The last name of the customer.

data.email

string

required

The email address of the customer.

data.primaryPhone

string

required

The primary phone number of the customer. (E.164 format)

data.address

object

required

The address of the customer.

Show child attributes

data.address.zip

string

required

The zip code of the address. Use 5 digits (12345) or 9 digits (12345-1234) format.

data.address.line1

string

The first line of the address.

data.address.line2

string

The second line of the address (e.g., apartment, suite, unit number).

data.address.city

string

The city of the address.

data.address.state

string

The state of the address.

data.middleName

string

The middle name of the customer.

data.secondaryPhone

string

The secondary phone number of the customer. (E.164 format)

data.ssnLastFour

string

The last four digits of the customer's Social Security Number. Required for collections customers.

Required string length: 4

data.dateOfBirth

string

The date of birth of the customer. YYYY-MM-DD format. Required for collections customers.

Create Customer Create Customers in Bulk

⌘I

Customers

Calls

Drip Campaigns

Webhooks

Authorizations

Path Parameters

Body

Response